package com.nari.ncps.screen.service.coal;

import com.baomidou.mybatisplus.extension.service.IService;
import com.nari.ncps.screen.entity.coal.CoalOverviewItem;
import com.nari.ncps.screen.vo.coal.CoalBasicInfoVO;
import com.nari.ncps.screen.vo.coal.CoalMineIntroVO;
import com.nari.ncps.screen.vo.coal.CoalTopIndicatorsVO;
import com.nari.ncps.screen.vo.coal.CoalUndergroundPersonnelVO;

/**
 * <p>
 * 产业总览信息表 服务类
 * </p>
 *
 * @author xuesong
 * @since 2025-08-23
 */
public interface CoalOverviewItemService extends IService<CoalOverviewItem> {

    /**
     * 获取煤炭产业顶部指标
     * @param year 年份（可选）
     * @return 煤炭产业顶部指标
     */
    CoalTopIndicatorsVO getTopIndicators(Integer year);
    
    /**
     * 获取矿区简介
     * @param orgCode 单位编码
     * @return 矿区简介VO
     */
    CoalMineIntroVO getMineIntro(String orgCode);
    
    /**
     * 获取煤矿基本信息
     * @param orgCode 单位编码
     * @return 煤矿基本信息VO
     */
    CoalBasicInfoVO getBasicInfo(String orgCode);
    
    /**
     * 获取坑下人员情况
     * @param orgCode 单位编码
     * @return 坑下人员情况VO
     */
    CoalUndergroundPersonnelVO getUndergroundPersonnel(String orgCode);
}
